HR - Employees - REST API icon

HR - Employees - REST API

(0 reviews)

REST GET CompensationReview specification

This operation allows to retrieve compensation data from CIM (HR data hub containing compensation data updated into Taliris) with a pagination mechanism.

REQUEST

url: /rest/v1/hr/compensationReview

Headers

The table below provide the details of the headers to be used when making the request.

Header NameDescription
client_idClient id having authorization to the endpoint(To be provided by DALI team)
client_secretClient secret having authorization to the endpoint(To be provided by DALI team)

Query Parameters

The table below provide the details of the query parameters that can be used when to query the webservice.

Parameter NameMandatoryDescriptionExample
erpSourceYErp source for which to get dataSAGE_CIV
lastUpdateDateYModication date using ISO 8601 date format 'YYYY-MM-DD HH:MI:SS' or 'YYYY-MM-DD'
Rule:
1) If HH:MI:SS is not precised, data for whole day is returned.
2) If an inferior date with a difference greater than 12 months is received, last 12 months data will be returned from today's date.
3) If an inferior date with a difference less than or equal to 12 months is received, data from the requested date to today's date will be returned.
2023-01-01 10:00:00
pageNThe page number to be returned1
limitNThe number of rows to be returned per page(maximum : 500)100

RESPONSE

Here is the format of the expected response

{
    "header": {
        "apiName": "{name of the DALI API processing the request}",
        "apiVersion": "{version of the DALI API processing the request}",
        "correlationId": "{correlationId generated by DALI conveyed all along the transaction}"
    },
    "data": {
        "payrollRespRubricList": [
            {
                "employeeErpId": "{Id of the employee}",
                "idRoc": "{Id of the employee in ROC}",
                "osmoseCode": "{company code in the ROC where employee is found}",
                "periodicity": "{Frequency of the series}",
                "amount": "{amount of the payment rubric}",
                "topRubric": "{payroll section}",
                "updateDate": "{modification date}",
                "effectiveDate": "{effective date}"
            }
        ],
        "payrollRespPromList": [
            {
                "employeeErpId": "{Id of the employee}",
                "idRoc": "{Id of the employee in ROC}",
                "osmoseCode": "{company code in the ROC where employee is found}",
                "effectiveDate": "{effective date}"
                "promotion": "{promotion type}",
                "promotionValue": "{promotion value}",
                "updateDate": "{modification date}",
            }
        ]
    },
    "links": {
        "selfRef": "{link to the requested page}",
        "firstRef": "{link to the first page}",
        "previousRef": "{link to the previous page}",
        "nextRef": "{link to the next page}",
        "lastRef": "{link to the last page}"
    },
    "limit": {number of rows returned per page},
    "currentPage": {current page number},
    "totalPages": {total number of pages}
}

MAPPING

Here are further information on each field in the response:

BlockFieldTypeDescriptionExample
headerapiNamestringName of the DALI API processing the requesthr-exp
headerapiVersionstringVersion of the DALI API processing the request1.0.0
headercorrelationIdstringUnique identifier generated by DALI conveyed all along the transactionab1251561-zdzdz2664-dz162262
data.payrollRespRubricListemployeeErpIdstringId of the employee in the ERP766666
data.payrollRespRubricListidRocstringId of the employee in ROC821890
data.payrollRespRubricListosmoseCodestringCompany code in the ROC where employee is found28031
data.payrollRespRubricListperiodicitystringFrequency of the seriesANNUAL_AMOUNT
data.payrollRespRubricListamountdecimalAmount of the payment rubric9999.99
data.payrollRespRubricListtopRubricstringPayment sectionSALB
data.payrollRespRubricListupdateDatedateTimeModification date - format 'YYYY-MM-DDTHH:MI:SS'2021-02-23T16:49:00
data.payrollRespRubricListeffectiveDatedateEffective date - format 'YYYY-MM-DD'2021-03-01
data.payrollRespPromListemployeeErpIdstringId of the employee in the ERP777777
data.payrollRespPromListidRocstringId of the employee in ROC821892
data.payrollRespPromListosmoseCodestringCompany code in the ROC where employee is found28035
data.payrollRespPromListeffectiveDatedateEffective date - format 'YYYY-MM-DD'2021-03-01
data.payrollRespPromListpromotionstringPromotion typeVE_KP22_STATUS
data.payrollRespPromListpromotionValuestringPromotion valueMA_CADRE
data.payrollRespPromListupdateDatedateTimeModification date - format 'YYYY-MM-DDTHH:MI:SS'2021-02-23T00:00:00
data.linksselfRefstringLink to the requested pagehttps://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=3
data.linksfirstRefstringLink to the first pagehttps://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=1
data.linkspreviousRefstringLink to the previous pagehttps://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=2
data.linksnextRefstringLink to the next pagehttps://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=4
data.linkslastRefstringLink to the last pagehttps://hr-exp.dali-latest.vinci-energies.net/rest/v1/compensationReview?erpSource=HRA&lastUpdateDate=2022-01-01%2000:00:00&limit=100&page=10
datalimitIntegerNumber of rows returned in page100
datacurrentPageIntegerCurrent page number3
datatotalPagesIntegertotal number of pages10

Reviews